═══ 1. 1. Einleitung ═══ PLOT ist eine Applikation fБr OS/2, mit der man, ausgehend von numerischen Daten, Graphiken erzeugen und ausdrucken kann. Die Graphiken kФnnen auсerdem als Windows 3.x Bitmaps exportiert werden. Auf diese Weise kФnnen sie in jedem Dokument eingebunden werden, daс mit einem anderen Programm -beispielsweise einem Textverarbeitungsprogramm- erzeugt worden ist. Charakteristika dieser Version Aufruf von PLOT von anderen Programmen aus ═══ 1.1. 1.1 Charakteristika dieser Version ═══ Version 1.5 ■ VollstДndig 32-bittige Architektur ■ Graphikexport als Windows 3.x Bitmapdatei ■ WahlmФglichkeit fБr Linientypen, Farben und Symbole ■ TastenkБrzel, um schnellen Zugriff auf Befehle zu ermФglichen ■ Verbesserte Druckfunktion fБr Graphiken ■ Einfache Erzeugung von numerischen Dateien mittels eines Texteditors ■ Speicherbare Einstellungen ■ Interaktive Hilfe fБr alle MenБpunkte mit der Funktionstaste F1 ■ Leicht zu bedienen ═══ 1.2. 1.2 Aufruf von PLOT von anderen Programmen aus ═══ Diese Information richtet sich an all jene Entwickler, die Applikationen schreiben, die graphische UnterstБtzung unter OS/2 Version 2 benФtigen. Wenn Sie eine OS/2 Applikation schreiben, die X-Y Graphiken erzeugen muс, kann Ihnen PLOT sehr viel Arbeit ersparen. PLOT kann von jedem Programm aus durch Erzeugung eines Sohnprozesses via DosExecPgm gestartet werden. Wenn Sie eine kommerzielle Applikation schreiben, kФnnen Sie PLOT Ihrem Softwarepaket beifБgen. In diesem Fall muс eine RegistrierungsgebБhr fБr jede verkaufte Version bezahlt werden. Falls Sie daran interessiert sind, PLOT zusammen mit Ihrer kommerziellen Software zu benutzen, bitten wir Sie, Kontakt mit uns aufzunehmen. Schreiben Sie uns dafБr an die folgende Adresse: StegSoft Durlacher Allee 38 76131 Karlsruhe Deutschland Fax: +49 721 693242 ═══ 1.2.1. 1.2.1 Erzeugung eines Sohnprozesses ═══ Der folgende Beispielcode zeigt einen Weg, um PLOT von einem C-Programm aus zu starten. Als erstes wird eine Datei, die alle numerische Daten enthДlt, auf die Festplatte abgelegt. Danach wird ein Sohnprozeс mittels der Kernel-Funktion DosExecPgm erzeugt. Damit wird PLOT gestartet und die Datendatei wird automatisch geladen werden. #define INCL_DOSPROCESS #include RESULTCODES resc; CHAR szFailName[CCHMAXPATH]; CHAR szCommandLine[] = "plot\0yourdata.plt\0"; /* * Die folgende Funktion schreibt die numerischen Daten in * die Datei "yourdata.plt". Sie ist nicht in diesem Paket * enthalten, aber Sie kФnnen Sie von uns bekommen. */ SavePlotData("yourdata.plt", xdata, ydata, flags); DosExecPgm(szFailName, /* Object-name buffer */ sizeof(szFailName), /* Length of buffer */ EXEC_ASYNC, /* Async flag */ szCommandLine, /* Argument string */ (PSZ) NULL, /* Environment string */ &resc, /* Address of result */ "plot.exe"); /* Name of application */ ═══ 2. 2. Systemanforderungen ═══ PLOT wurde mit einem 32-bit Compiler Бbersetzt, um die Vorteile der neuen Version des Betriebssystems OS/2 auszunutzen. Die Anforderungen, um das Programm benutzen zu kФnnen, sind die folgenden: ■ Auf dem Prozessor 386 oder hФher basierendes System ■ 6,0 MB Hauptspeicher ■ Ein Diskettenlaufwerk ■ Eine Festplatte mit 200 kB frei ■ Betriebssystem OS/2 Version 2.0 oder hФher ■ Eine Maus Die VerfБgbarkeit eines arithmetischen Koprozessors 387 oder 487 ist nicht nФtig, um PLOT zu benutzen. Trotzdem wird der Koprozessor benutzt, falls er vorhanden ist. Daraus ergeben sich wesentliche Geschwindigkeitsvorteile. ═══ 3. 3. Installation ═══ Um das Programm PLOT zu installieren, kopieren Sie die Datei plot.exe in ein Verzeichnis Ihrer Festplatte. Die Hilfedatei plot.hlp muс in ein Verzeichnis kopiert werden, das in der Umgebungsvariablen HELP (siehe Datei CONFIG.SYS) eingetragen wurde. Wenn Sie von jedem Verzeichnis aus auf dieses Handbuch zugreifen mФchten, sollten Sie den Verzeichnisnamen, in dem sich die Datei befindet, zu den EintrДgen der Umgebungsvariablen BOOKSHELF hinzufБgen (siehe Datei CONFIG.SYS). Nachdem Sie diese Schritte ausgefБhrt haben, sollte sich auf Ihrer Festplatte eine lauffДhige PLOT-Version befinden. Man kann auсerdem das Programm PLOT in die OS/2 OberflДche integrieren. Wenden Sie sich dafБr an den Abschnitt Integration in die OS/2-OberflДche dieses Handbuches. ═══ 4. 4. Dateiformat ═══ Bevor man einen Datensatz laden kann, um daraus eine Graphik zu erzeugen, muс eine Datei mit den Zahlenwerten erzeugt werden. Damit das Programm in der Lage ist, die Daten korrekt zu interpretieren, mБssen sie ein bestimmtes Format einhalten. Die Datendateien kФnnen einfach mit Hilfe eines Texteditors erzeugt und verДndert werden. Wenn Sie Бber eine komplette OS/2 2.x Installation verfБgen, sollten sich auf Ihrer Festplatte zwei Editoren befinden: der OS/2 Systemeditor (E.EXE) und der erweiterte Editor (EPM.EXE). Jeder dieser zwei Editoren eignet sich, um die zur Erzeugung einer Graphik nФtigen Datendateien einzugeben. Wenn Sie eine numerische Datendatei erzeugen, sollten Sie die Erweiterung *.plt verwenden, weil diese als Standarderweiterung von dieser Software benutzt wird. Die Datendateien mБssen die Beschreibung eines Punktes in jeder Zeile enthalten. Dabei gibt es zwei MФglichkeiten, um die Punkte zu beschreiben. Wenn Sie fБr die Punkte jeweils x- und y-Werte spezifizieren (parametrische Daten), muс die Datei zwei Zahlenspalten enthalten. Die erste wird die x-Werte eines jeden (x,y)-Paares enthalten, wДhrend in der zweiten die y-Werte angegeben werden mБssen. Die x-Komponente jedes Paares (x,y) kann aber weggelassen werden. In diesem Fall wird jedem x-Wert die aktuelle Koordinatenzahl zugeordnet. Die Koordinatenzahl fДngt mit 0 an und wird nach jedem eingelesenen Wert um eins erhФht. Diese Darstellung eignet sich besonders fБr Дquidistante Abtastwerte. In beiden FДllen kФnnen Kommentare in jede Zeile eingefБgt werden, die das Zeichen ; in der ersten Spalte enthДlt. Diese Zeilen werden von PLOT ignoriert. Einige Kurvenparameter, wie die Farbe, der Linientyp und der Symboltyp kФnnen ebenfalls durch hinzufБgen von Befehlen ausgewДhlt werden. Dabei fangen alle Befehle mit dem Zeichen # an. Ein Befehl darf mehrmals in einer Datei enthalten sein, aber in diesem Fall wird von PLOT nur der letzte Eintrag berБcksichtigt werden. Es sind 3 Befehle verfБgbar: o #COLOR o #LINE o #MARKER Im Folgenden befinden sich zwei Beispiele: ein Beispiel fБr eine Datei mit parametrischen Daten und ein Beispiel mit einer Datei mit nichtparametrischen Daten. Parametrische Datei Nichtparametrische Datei ═══ 4.1. 4.1 #COLOR-Befehl ═══ Benutzen Sie diesen Befehl, um die Farbe eines Graphen auszuwДhlen. Dieser Befehl bietet die folgenden Optionen: WHITE BLACK BACKGROUND BLUE RED PINK GREEN CYAN YELLOW NEUTRAL DARK_GRAY DARK_BLUE DARK_RED DARK_PINK DARK_GREEN DARK_CYAN BROWN PALE_GRAY Beispiel: #COLOR BLUE ═══ 4.2. 4.2 #LINE-Befehl ═══ Benutzen Sie diesen Befehl, um den Linientyp eines Graphen auszuwДhlen. Dieser Befehl bietet die folgenden Optionen: DOT SHORT_DASH DASH_DOT DOUBLE_DOT LONG_DASH DASH_DOUBLE_DOT SOLID INVISIBLE ALTERNATE Beispiel: #LINE LONG_DASH ═══ 4.3. 4.3 #MARKER-Befehl ═══ Benutzen Sie diesen Befehl, um den Symboltyp eines Graphen auszuwДhlen. Dieser Befehl bietet die folgenden Optionen: NONE CROSS PLUS DIAMOND SQUARE 6-POINT-STAR 8-POINT-STAR SOLID_DIAMOND SOLID_SQUARE DOT CIRCLE Beispiel: #MARKER SOLID_SQUARE ═══ 4.4. 4.4 Parametrische Datei ═══ #COLOR RED #LINE ALTERNATE #MARKER SOLID_SQUARE ; x- und y-Werte 0 0 0.5 0.25 1 1 1.5 2.25 2 4 2.5 6.25 3 9 3.5 12.25 4 16 ═══ 4.5. 4.5 Nichtparametrische Datei ═══ #COLOR BLUE ; nur y-Werte 0 1 4 9 16 25 ═══ 5. 5. Aufruf von PLOT ═══ Um das Programm PLOT zu starten, tippen Sie von der OS/2 Befehlszeile: plot test.plt wobei test.plt der Dateiname des darzustellenden Graphens ist. Dieser Parameter ist optional. Es gibt andere Wege, um dieses Programm zu starten; sie werden aber im Abschnitt Integration in die OS/2-OberflДche beschrieben. ═══ 6. 6. Benutzung von PLOT ═══ In diesem Abschnitt werden die PLOT-MenБs kurz beschrieben. Bitte wenden Sie sich an die interaktive Hilfe, um detalliertere Informationen Бber die hier beschriebenen Funktionen zu erhalten. File-MenБ Options-MenБ Help-MenБ ═══ 6.1. 6.1 File-MenБ ═══ Benutzen Sie dieses MenБ, um Graphen zu laden, Graphiken auszudrucken oder zu exportieren und um das Programm zu verlassen. Das File-MenБ enthДlt die folgenden Befehle: New... Щffnet eine Datendatei und erzeugt eine neue Graphik. Open... Щffnet eine Datendatei und bindet die Kurve in die aktuelle Graphik ein. Export... Exportiert die aktuelle Graphik als eine Windows 3.x Bitmapdatei. Print... Gibt die aktuelle Graphik auf dem Drucker aus. Exit VerlДсt das Programm. ═══ 6.2. 6.2 Options-MenБ ═══ Benutzen Sie dieses MenБ, um Ihre aktuelle Graphik zu verДndern, einen Texteditor zu starten oder die aktuellen Einstellungen zu speichern. Das Options-MenБ enthДlt die folgenden Befehle: Graphic... Erlaubt die Wahl neuer Grenzen fБr die Graphik, die Achsen zu beschriften und die Zeichenoptionen fБr die Graphik einzustellen. Set Font... Erlaubt die Wahl von Schriftart und -grФсe. Graph... Erlaubt, die Zeichenoptionen eines Graphens (Farbe, Linientyp und Symboltyp) zu verДndern. Edit Data File Startet einen Texteditor, um neue Datendateien zu erzeugen oder vorhandene zu verДndern. Save options Benutzen Sie diesen Befehl, um die aktuellen Einstellungen zu speichern. ═══ 6.3. 6.3 Help-MenБ ═══ Dieses MenБ erlaubt es Ihnen, die interaktive Hilfe zu benutzen und informiert Sie Бber die Programmversion, mit der Sie arbeiten. Das Help-MenБ enthДlt die folgenden Befehle: Help index Ъber diesen Befehl erhalten Sie Zugriff auf das Hilfeverzeichnis. General help Benutzen Sie diesen Befehl, um eine kurze Beschreibung Бber PLOT zu erhalten. Using help Hier kФnnen Sie lernen, wie man die interaktive Hilfe benutzt. Registration information Zeigt die Registrierungsdaten an (erst wenn Sie eine registrierte Version erworben haben). Product information Zeigt Programmversion und Copyright an. ═══ 7. 7. Integration in die OS/2-OberflДche ═══ Wenn Sie die Installation erfolgreich abgeschlossen haben, kФnnen Sie ein Programmobjekt erzeugen, um PLOT direkt von der OS/2-OberflДche aus starten zu kФnnen. Folgen Sie dafБr diesen Schritten: 1. Щffnen Sie den Ordner Schablonen. 2. Verschieben Sie eine Kopie der Schablone Programm auf die OberflДche oder auf einen Ordner. Ein Fenster wird erscheinen, in dem die Einstellungen des zu erzeugenden Objektes einzugeben sind. 3. Geben Sie den Pfad und den Namen des Programmes PLOT ein. Wenn Sie wБnschen, kФnnen Sie auch das Arbeitsverzeichnis in das entsprechende Feld eingeben. 4. Ordnen Sie Ihrem Programmobjekt einen Namen zu. Dies kФnnen Sie im MenБ Allgemeines des Einstellungen-Notizblocks durchfБhren. In dem Ordner Schablonen sollte sich nun eine Schablone mit dem Namen Plot-Data-File.PLT befinden. Diese Schablone kann benutzt werden, um Datenobjekte zu erzeugen. Diese werden automatisch mit dem Programm PLOT asoziiert. Um ein Datenobjekt zu erzeugen, folgen Sie diesen Schritten: 1. Щffnen Sie den Ordner Schablonen. 2. Verschieben Sie eine Kopie der Schablone Plot-Data-File.PLT auf die OberflДche oder auf einen Ordner. 3. Ordnen Sie Ihrem Datenobjekt einen Namen zu, ohne die Erweiterung *.PLT zu verДndern. Vermeiden Sie dabei Leerzeichen im Objektnamen, da sie zu Problemen beim Щffnen des Objektes fБhren kФnnten. 4. Щffnen Sie das Objekt durch Doppelklicken. PLOT wird erkennen, daс die Daten noch eingegeben werden mБssen und wird demnach einen Editor aufrufen. Geben Sie die gewБnschten Zahlenwerte ein, aus denen eine Graphik erzeugt werden soll. 5. Speichern Sie die Daten und verlassen Sie den Editor. Nach dem Verlassen des Editors wird PLOT die gewБnschte Graphik erzeugen. Um aus einem vorhandenen Datenobjekt eine neue Graphik zu erzeugen, kФnnen Sie verschiedene Wege beschreiten: o Щffnen Sie das Datenobjekt durch Doppelklicken. Das Programm PLOT wird automatisch gestartet werden und eine Graphik aus den Daten erzeugen. o Verschieben Sie das Datenobjekt und lassen Sie es Бber das PLOT-Programmobjekt fallen. Оhnliche Ergebnisse wie im vorhergehenden Beispiel sind zu erwarten. o Starten Sie PLOT durch Doppelklicken auf das Programmobjekt. WДhlen Sie den MenБpunkt File--Open, um eine Datendatei zu Фffnen. Aktivieren Sie in der Щffnen-Dialog-Box den Ordner, in dem Sie Ihr Datenobjekt erzeugt haben und Фffnen Sie das Objekt. ═══ 8. 8. Offline-Hilfe ═══ In diesem Abschnitt wird Ihnen erklДrt, an wen Sie sich wenden kФnnen, falls Sie Probleme im Umgang mit PLOT haben sollten, oder Ihnen Bugs oder InkompatibilitДten auffallen sollten. ═══ 8.1. 8.1 Hotline ═══ Jeder registrierte Benutzer kann eine Hotline benutzen. Bitte schreiben oder faxen Sie uns, falls Sie irgendwelche Fragen Бber die Benutzung von PLOT, die neuesten verfБgbaren Versionen usw. haben. Oder falls Sie uns einfach mitteilen wollen, was Sie sich von diesem Programm noch wБnschen wБrden. Ihre Meinung wird uns helfen, um PLOT an Ihre persФnlichen WБnsche anzupassen. ═══ 8.2. 8.2 Bugs und UnkompatibilitДten ═══ Wir haben diese Programmversion ausgiebig getestet, bevor wir die Version Бber Shareware verteilt haben. Sollten Ihnen dennoch irgendwelche Bugs oder InkompatibilitДten auffallen, so bitten wir Sie, uns diese so schnell wie mФglich mitzuteilen. Senden Sie uns dafБr einen Brief bzw. ein Fax an die sich in diesem Handbuch befindliche Adresse bzw. Faxnummer. ═══ 9. 9. Registrierung ═══ Um dieses Programm zu testen, verfБgen Sie Бber 14 Tage. Nach dieser Zeit mБssen Sie entweder eine registrierte Version erwerben oder aufhФren, das Programm zu benutzen. Bitte unterstБtzen Sie das Shareware-Konzept und bestellen Sie eine registrierte Version von PLOT bei der folgenden Adresse (bzw. Faxnummer): StegSoft Durlacher Allee 38 76131 Karlsruhe Deutschland Fax: +49 721 693242 Nach Eingang Ihrer Bestellung werden Sie die neueste PLOT-Version gegen DM 30,- (oder U.S. $20) erhalten. Wenn Sie in Europa leben, fБgen Sie bitte DM 5,- fБr Porto und Versand bei. Der Erwerb einer registrierten Version hat die folgenden Vorteile: o Die registrierten Versionen von PLOT verfБgen nicht Бber die Nachricht, die Sie jedes Mal wenn sie eine Graphik ausdrucken daran erinnert, eine registrierte Version zu erwerben. Die Shareware-Version verfБgt darБber, weil sie nur fБr Testzwecke gedacht ist. o Es sind registrierte Versionen von PLOT in drei Sprachen verfБgbar: Englisch, Deutsch und Spanisch. Sie kФnnen entscheiden, welche Sprache Sie bevorzugen. Im Gegensatz dazu ist die Shareware-Version nur auf Englisch verfБgbar. Bitte benutzen Sie fБr die Bestellung das in diesem Handbuch enthaltene Formular. Folgen Sie diesen Schritten, um es auf Ihrem Drucker auszugeben: 1. Klicken Sie zweimal den folgenden Text an: PLOT Bestellungsformular. 2. DrБcken Sie den Button Drucken. 3. Versichern Sie sich, daс die Option Dieser Abschnitt ausgewДhlt ist. 4. DrБcken Sie erneut den Button Drucken. Das Bestellungsformular wird auf Ihrem Drucker ausgegeben werden. Bitte schicken Sie die Bestellung an obige Adresse bzw. Faxnummer. ═══ 9.1. 9.1 StegSoft PLOT - Preisliste ═══ ┌────────────────────┬────────────┬──────────────┐ │Produkt │U.S. Dollar │Deutsche Mark │ ├────────────────────┼────────────┼──────────────┤ │PLOT 1.4 fБr OS/2 │20 │30 │ ├────────────────────┼────────────┼──────────────┤ │PLOT Update (von │5 │8 │ │jeder registrierten │ │ │ │Version) │ │ │ └────────────────────┴────────────┴──────────────┘ ═══ 9.2. 9.2 StegSoft PLOT - Bestellungsformular ═══ Name ___________________________________________________________ Adresse ___________________________________________________________ Ort __________________________________________ PLZ ____________ Land ___________________________________________________________ Telefonnummer (optional) _____________________ Zuhause / Arbeit Lieferung (WДhlen Sie eine Option aus): __ Per Post, Geld liegt bei (zzgl. DM 5,- Porto, fБr Bestellungen innerhalb von Europa) __ Per Post, gegen Nachnahme (zzgl. Porto) WДhlen Sie das von Ihnen gewБnschte Diskettenformat: __ 5 1/4" __ 3 1/2" Bezahlungsart: __ Scheck in DM oder US Dollar liegt bei __ Geld liegt bei (bitte nur DM oder US Dollar!) __ Gegen Nachnahme PLOT fБr OS/2 2.x RegistrierungsgebБhr (DM 30,-) ______ PLOT Update von jeder registrierten Version (DM 8,-) ______ Porto fБr Versand ______ Gesamtbetrag ______ Schicken oder faxen Sie dieses Formular an: StegSoft Durlacher Allee 38 76131 Karlsruhe Deutschland Fax: +49 721 693242 *** Vielen Dank fБr Ihre Bestellung! ***